SGSetChannelPlayFlags(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuration Functions for All Channel Components

SGSetChannelPlayFlags
The SGSetChannelPlayFlags function allows the sequence grabber component to influence the speed and quality with which your channel component displays data from its source.
pascal ComponentResult SGSetChannelPlayFlags (SGChannel c, 
                                              long playFlags);
c
Identifies the channel connection for this operation.
playFlags
Specifies a long integer that contains flags and values that influence channel playback. The following values are defined--the sequence grabber component must use one of these values:
channelPlayNormal

Instructs your channel component to use its default playback methodology.
channelPlayFast

Instructs your channel component to sacrifice playback quality in order to achieve the specified playback rate.
channelPlayHighQuality

Instructs your channel component to play the channel's data at the highest possible quality--this option sacrifices playback rate for the sake of image quality. This option may reduce the amount of processor time available to other programs in the computer. This option should not affect the quality of the recorded data, however.

The following flag is defined--the sequence grabber component may use this flag with any of the values defined for this parameter (unused flags are set to 0):
channelPlayAllData
Instructs your channel component to try to play all of the data it captures, even the data that is stored in offscreen buffers. This option is useful when you want to be sure that the user sees as much of the captured data as possible. The sequence grabber component sets this flag to 1 to play all the captured data. The sequence grabber component may combine this flag with any of the values defined for the playFlags parameter.

DESCRIPTION
The SGSetChannelPlayFlags function should not affect the quality of a record operation.